home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / contents / lettplus < prev    next >
Text File  |  1993-07-28  |  6KB  |  125 lines
  1.  
  2.  From the Guys and Gals at APLUS, 
  3.  
  4.  
  5.       First of all, thanks to everyone who has participated in and
  6.  contributed to the success of the ASP CD-ROM BETA project.  In add-
  7.  ition, thanks in advance for your comments, suggestions and patience
  8.  as we prepare for the ASP CD-ROM FIRST EDITION.  
  9.  
  10.       For a Beta release we believe we've had a successful beginning.
  11.  (The CD is together and actually works.)  We did however encounter a
  12.  few problems.  With your help and a few bug fixes (You guys do know
  13.  about bugs, right?) we hope to eliminate the bulk of the problems and
  14.  make the submission process, CD-ROM construction and BBS operation
  15.  as glitch free as possible.  
  16.       
  17.       To start on a positive note almost everyone did it right.  About
  18.  90% of the 250 (or so) programs submitted arrived in a format that
  19.  we could move to the CD-ROM using limited automation.  A few were so
  20.  creative we had to call for help.  All in all it went fairly smooth.
  21.  Following is a list of some of the problems and some ways to improve.
  22.  
  23.    1.  BUG IN ASPEDIT.  One of the biggest problems was a creature of
  24.        our own creation.  ASPEDIT outputs a comma delimited ASCII .ASP 
  25.        file which we import into a database.  Unfortunately it should 
  26.        have been a comma/quote delimited ASCII file.  What happened 
  27.        was every time an author used a comma in one of the ASPEDIT 
  28.        fields the database imported it as a new field.  We had to do a 
  29.        lot of manual editing. (Virtually every single one.)  We fixed 
  30.        this bug.  Please, When you resubmit use the newest version of 
  31.        the ASPEDIT program.  (There is a copy of the fumigated version
  32.        in the \CONTENTS directory.  ASPEDIT v1.2)
  33.       
  34.    2.  FILENAMES AND SUBMISSION DISKS.  The submission disk should
  35.        contain three things.  Using the program YOURPROG as an example
  36.        the directory on the submission disk should look something 
  37.        like:
  38.           
  39.            YOURPROG       <DIR>  01-23-90  10:51p
  40.            YOURPROG.ASP    2013  01-24-90  10:52p
  41.            YOURPROG.ZIP  232342  02-25-91  10:53p
  42.                   2 File(s)     265734 bytes
  43.                                 543453 bytes free
  44.  
  45.        The directory should contain the ready-to-run or ready-to-
  46.        install version of your program.  Even if your program cannot 
  47.        run from a CD-ROM it can most likely be installed and even if 
  48.        it can't be installed or run DOC and README files can still be
  49.        reviewed.
  50.  
  51.        The YOURPROG.ASP file is the file created by the ASPEDIT 
  52.        program and should be located in the "root" directory of the 
  53.        submission disk.  It is very important that all three names are 
  54.        exactly the same.  (We know there will be exceptions to this 
  55.        structure.  If for some reason you cannot use this structure 
  56.        you can help us by including a note explaining what and why.
  57.  
  58.        YOURPROG.ZIP is the archived version of your program.  These 
  59.        are the files that will be made available by BBS's.  If your 
  60.        program is distributed in a 2 or more disk set you need to name 
  61.        the file using the letter A, B, C, etc. as the last letter in 
  62.        the filename.  Example:
  63.  
  64.            YOURPROA.ZIP
  65.            YOURPROB.ZIP
  66.            YOURPROC.ZIP     etc...
  67.      
  68.        Note: You only need 1 .ASP file per program and it should be
  69.        named whatever your first disk's name is.  In the above 
  70.        example the .ASP files would be named YOURPROA.ASP.
  71.  
  72.    3.  FILENAME CONVENTIONS.  On a CD-ROM certain characters cannot 
  73.        be used as filenames.  A CD-ROM recognizes ONLY the letters 
  74.        A-Z, the numbers 0-9 and the _ character. (underscore)  Make 
  75.        sure that your subdirectory, .ASP and .ZIP files contain only 
  76.        these characters.
  77.  
  78.    4.  CONSISTANCY.  Some authors had special requests such as being
  79.        included on the CD-ROM only as a BBS download.  While we will
  80.        try to accommadate any such request it is still very important
  81.        that we recieve the .ASP file in the correct location on the
  82.        submission disk.  Without the .ASP file our database cannot
  83.        generate the BBS file listing so we have to create the .ASP
  84.        file or wait for you to send us one.
  85.  
  86.        One of the most common misconceptions is that if your program
  87.        will not run from the CD-ROM there is no need to have an
  88.        unpacked version.  Even if it won't run it can probably be
  89.        installed from CD and even if it can't be installed your text
  90.        files and any special README's can still be reviewed.
  91.  
  92.    5.  CREATE SPECIAL DOCUMENTATION.  This is not a problem, just a
  93.        suggestion.  If your program cannot be run straight from the
  94.        CD-ROM the most helpful feature you could add would be a
  95.        README that explains how to install the program.  If at all
  96.        possible try to create an install routine that can install
  97.        from the CD.  We realize that some applications may not be
  98.        able to do this.  If this is the case a README that explains
  99.        the program must be copied to a floppy disk to be installed
  100.        would be very helpful.  (Note:  After reviewing the BETA
  101.        version of the ASP CD you may note that some of the CD-ROM
  102.        access program's features such as copying would helpful to 
  103.        mention in your documentation.)
  104.  
  105.  
  106.  BBS SYSOPS
  107.  
  108.      The BBS files are located in the subdirectory created for each
  109.  category.  If the files are not formatted for your BBS and there
  110.  is no easy way to reformat them please let us know.  Send us the
  111.  information we need to know.  Examples of your text files, limits
  112.  or capabilities of you system, and any suggestions as to how we
  113.  can accomodate your need.  We cannot promise that we will support
  114.  every board but we will try.  
  115.  
  116.  
  117.       Considering the number of people involved and the diversity of
  118.  of programs submitted we feel the BETA release ASP CD-ROM has been
  119.  a resounding success.  As with any program or system we expect to
  120.  see improvements with each successive edition.  Again, to all those 
  121.  who participated and to those who would like to be included in the
  122.  ASP CD-ROM project, thanks.
  123.  
  124.                                    -- Advantage Plus Dist., Inc.
  125.